home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 44 / Amiga Format CD44 (1999-08-26)(Future Publishing)(GB)(Track 1 of 3)[!][issue 1999-10].iso / -in_the_mag- / basics / amos / amos2c.lha / Amos2C.readme < prev   
Text File  |  1998-09-02  |  3KB  |  98 lines
  1. Short:    V0.3b Converts Amos source structure to C
  2. Author:   burkey@bigfoot.com (Paul Burkey)
  3. Uploader: burkey@bigfoot.com (Paul Burkey)
  4. Type:     dev/amos
  5.  
  6. First of all, this is not a miracle utility to create 'ready to compile'
  7. C source code but it should make life much easier for those willing to
  8. 'port' some AMOS code to C.
  9.  
  10. Secondly, this utility has been developed to help me to 'port' my old
  11. Amos game "Sneech" to C, which should allow me to develop the game
  12. further with support for AGA, GFX cards, various CPU's and OS's. The
  13. job of 'porting' the game to C will be done in my spare time so I
  14. plan to develop Amos2C as far as possible to make the final job easier.
  15.  
  16. History
  17. -------
  18.  
  19. V0.3b
  20.  
  21. Proper parsing of For..Next loops.
  22. Proper parsing of If and While conditions.
  23. All condition '<>' converted to '!='
  24. All condition '=' converted to '=='
  25. Now indents code using TAB's rather than spaces
  26.  
  27. V0.2b
  28.  
  29. First release so everything is new!
  30.  
  31.  
  32.  
  33. Now some Faq's
  34. --------------
  35.  
  36. What does it convert?
  37.  
  38. It should convert most Amos structure such as If..Else..End If. The
  39. basic Do..Loop, a partial For..Next convertion. Procedures are converted
  40. to C Functions and most of the procedure arguments are dealt with. The
  41. global Dim's are converted into Global int's. All comments will be
  42. converted to /* */ or // style comments. The whole source code is indented
  43. and parsed in a rather neat way. Some simple commands are converted eg,
  44. 'Inc A' becomes 'A++', 'Exit' becomes 'break', 'Pop Proc' becomes 'return'
  45. and a ';' should be appended to any line that requires one. It will even
  46. add some prototypes at the top of the source code!
  47.  
  48. What doesn't is convert?
  49.  
  50. No 'usefull' commands are converted so don't expect to be rendering graphics
  51. or playing sounds. All procedures are converted to functions returning
  52. Void even if they do return values. Many, many more problems but development
  53. is ongoing so things will improve.
  54.  
  55. What next?
  56.  
  57. I'll tidy up some of the convertion process and fix the few problems
  58. mentioned above, then I'll attemt to convert as many of the basic
  59. Amos syntax as possible eg 'Add a,7' should become 'a+=7' which is
  60. one of many simple things that could make life easier.
  61.  
  62. Why doesn't it do more!?
  63.  
  64. I must say that this program is the result of two days work so far. Please
  65. be patient and more good stuff will come!
  66.  
  67. Contact me....
  68.  
  69. If you think this program deserves further development then please
  70. get in touch with me an let me know what your needs are. Please
  71. beware of any amos source that uses lots of goto's or gosub's...
  72. They will not convert to C very easily and you'll be in for a
  73. hard time.
  74.  
  75. *Please note:* I don't require any specific bug reports at the
  76. present time. This release is only intended as a taste of what will
  77. come and to give me some feedback from interested potential users.
  78. The program has only been tested with two BIG amos source files
  79. an the results were prety good. If you have any amos code you
  80. would like to 'donate' to help me to improve the parsing then
  81. please email it to me in ascii format.
  82.  
  83. Usage: (via cli only)
  84.  
  85. Amos2c [amos.ascii]
  86.  
  87. thats it...
  88.  
  89. Feel free to contact me about this program at the email address found
  90. at the end of this file. I don't plan to ever make a 100% full
  91. amos to c convertion but I do expect to make Amos->C convertion jobs
  92. much easier!
  93.  
  94. Thank you,
  95.  
  96. Paul Burkey <burkey@bigfoot.com>
  97.  
  98.